home *** CD-ROM | disk | FTP | other *** search
/ Network Support Library / RoseWare - Network Support Library.iso / swmeter / lock.exe / pak / LOCKER.DOC next >
Text File  |  1993-03-28  |  6KB  |  129 lines
  1. ---------------------------------------------------------------------
  2. LOCKER.EXE Quickstart Manual                                 Ver 1.20
  3. Copyright (C) 1993 - AccuSys Computer Services    ALL RIGHTS RESERVED
  4. ---------------------------------------------------------------------
  5.  
  6. Licence limit enforcement is becoming a major concern to public and
  7. private corporations and organizations alike. The problem with most
  8. commercial or shareware usage tracking programs is that they perform
  9. their functions using some pretty elaborate methods, for example:
  10.  
  11.     a. Database tracking - A database is created and hold all lock data
  12.       
  13.          This can be really sloppy, not only must a database engine be
  14.          operating (and taking up memory) to maintain this database
  15.          but doing so may gobble up valuable system resources like
  16.          file handles and cache memory. Also, if the database corrupts
  17.          unexpectedly you may be faced with having to re-key all your
  18.          licence information. Should you wish to change metering programs
  19.          at a later date you can almost bet that the databases won't be
  20.          compatible.
  21.  
  22.     b. Executable modification - The program is modified to add a 
  23.        special pre-load header which checks the lock information before
  24.        running.
  25.  
  26.          A potentially dangerous option. These type of programs directly 
  27.          change your operational executable programs. Some programs may
  28.          not like this type of hacking and may simply stop. If you operate
  29.          any kind of virus scanner that checks for program modification
  30.          you can expect it to tilt when it finds that a program has been
  31.          modified by your locking program. Also, should the pre-load header
  32.          consult a database for it's information, than you can add the
  33.          above disadvantages to this option as well.
  34.  
  35.     c. TSR - A resident program that sits around checking licences every
  36.        time a program is executed.
  37.  
  38.          This is the ultimate ugly solution. Many of your users a tight on
  39.          memory as it is without throwing yet MORE junk in there. TSR's are
  40.          notorious for causing compatibility problems with both applications
  41.          and systems software. TSR's may also hold files open on the server
  42.          thereby reducing the available file handles for other applications.
  43.  
  44. The LOCKER.EXE alternative:
  45.  
  46.     a. NO DATABASES to hog system resources or corrupt unexpectedly and
  47.        hang your whole system
  48.     b. NO OPEN FILES to reduce system resources
  49.     c. NO PROGRAM MODIFICATIONS that may crash a program or tilt a virus
  50.        scanning program.
  51.     d. NO TSR's chewing up your precious memory
  52.  
  53. Locker runs, checks lock status and exits. All files opened (only 2) are
  54. released immediately when the program terminates.
  55.  
  56. If you need additional help with this program, please call 416-734-1992 or
  57. for more direct assistance, please EMAIL compuserve address 71753,3522
  58.  
  59.  
  60. Step 1.
  61.  
  62.   Create a directory on a shared Netware drive which is to hold the
  63.   lock files. Users must be able to Filescan, Read, Create, and Erase
  64.   files in this directory. 
  65.  
  66. Step 2. 
  67.  
  68.    Establish handy abbreviations, I suggest 5 characters maximum, to
  69.    be used to identify your applications (eg. WP51 for WordPerfect 5.1)
  70.    This abbreviations will be used to create the USERLOCK.DAT file
  71.  
  72. Step 3.
  73.  
  74.    Using your favorite text editor (such as Edit, Edlin...etc) and create
  75.    a file called USERLOCK.DAT in the directory created in step 1.
  76.    
  77.    Each line of the file has the same pattern:
  78.  
  79.        APPL_ABBREVIATION        LICENCE_LIMIT
  80.  
  81.    The abbreviation is separated from the licence limit by whitespace 
  82.    (spaces, tabs, etc...) If LOCKER is called and the specified 
  83.    abbreviation cannot be found in USERLOCK.DAT the program will assume
  84.    a single user (1 user) licence and create a ???.001 file for the
  85.    requested application. This means that you only have to make
  86.    entries for those programs with a multi-user licence.
  87.  
  88.    A sample USERLOCK.DAT is included on the diskette. After you have
  89.    prepared your USERLOCK.DAT file, I would suggest FLAGing the file
  90.    Shareable, Read-Only. This will prevent users from deleting the file
  91.    if permissions were assigned as indicated above in step 1. Netware
  92.    3.11 users can use the Trustee File Permissions to grant Modify rights
  93.    to any users who must maintain the USERLOCK.DAT file.
  94.  
  95.    NOTE: Some of the sample applications use high licence limits. If you
  96.          are running the DEMO version of LOCKER these limits are 
  97.          automatically reduced to 10 by the program.
  98.  
  99. Step 4. 
  100.  
  101.    Create batch files to run your applications. Note that locker will
  102.    return a positive number (the lock file number) if successful. This  
  103.    facility was provided for users who might want to use the lock file
  104.    number in a batch file. On failure to lock the program will return
  105.    zero (0). A sample batch file might look like this:
  106.  
  107.       @ECHO OFF
  108.       LOCK F:\APPS\LOCKS LOCK WP51
  109.       IF ERRORLEVEL 1 GOTO CONTINUE
  110.       ECHO Sorry, all licences are in use. Please try again later.
  111.       GOTO END
  112.       :CONTINUE
  113.       WP51
  114.       LOCK F:\APPS\LOCKS UNLOCK WP51
  115.       IF ERRORLEVEL 1 GOTO END
  116.       ECHO Error unlock file, please advise LAN administrator.
  117.       :END
  118.  
  119. Step 5.
  120.  
  121.     I would suggest that you create some automated procedure for viewing
  122.     and cleaning LOCK files. Should a user reboot without exiting the 
  123.     application, a lock file will be left behind and will remain stranded
  124.     until it is removed. Lock files contain a viewable plain text header
  125.     which can be examined with the DOS "TYPE" command. To remove an
  126.     errant lock file simply delete it from the directory.
  127.  
  128.  
  129.